发送组合键 - KeyPressHotkey

函数简介

根据组合键字符串一次性完成 按下 → 逆序释放，支持纯修饰键组合（如 ctrl+alt 释放虚拟机鼠标捕获）、多修饰键 + 主键、左右修饰键区分等场景。

接口名称

KeyPressHotkey

DLL调用

int KeyPressHotkey(long ola, string hotkey_str, int delay);

参数说明

参数名	类型	说明
ola	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
hotkey_str	字符串	组合键字符串，多个键用 `+` 连接，如 `"ctrl+alt"`、`"alt+ctrl+a"`、`"lctrl+shift+f5"`。
delay	整数型	每个按键动作之间的间隔，单位毫秒（ms）。<=0 时使用 KeyDownInterval 配置（走 `KeyboardInterval()`）。

输入格式

分隔符：+（前后空白自动去除）
大小写：不敏感（ALT+A 与 alt+a 等价）
修饰键别名：

输入	默认 VK	显式左右
`ctrl` / `control` / `ctl`	VK_CONTROL	`lctrl` / `rctrl`
`alt` / `menu`	VK_MENU	`lalt` / `ralt`
`shift`	VK_SHIFT	`lshift` / `rshift`
`win`	VK_LWIN	`lwin` / `rwin`

主键：见虚拟键码表 - KeyPressCharMap 中的字符串键名（如 a、f1、enter）
大写字母不隐式加 Shift：alt+a 与 alt+A 相同；需要 Shift 须显式写 shift（如 ctrl+shift+a）

修饰键排序规则

条件	行为
组合中不含 Win	修饰键自动排序：Ctrl → Alt → Shift（如 `shift+alt+ctrl+a` → `ctrl+alt+shift+a`）
组合中含 Win	修饰键保持用户输入顺序（Microsoft 未定义 Win 在组合中的顺序）
主键（若有）	始终最后发送

支持的场景

场景	示例
纯修饰键（VM 释放鼠标）	`ctrl+alt`
常规快捷键	`ctrl+c`、`alt+f4`
多修饰键	`ctrl+shift+s`
左右键区分	`lctrl+ralt+a`

不支持：多个主键（如 ctrl+a+b 返回失败）。

示例

SDK 调用

cpp

#include "OLAPlugServer.h"

OLAPlugServer ola;
// 虚拟机释放鼠标捕获
int ret = ola.KeyPressHotkey("ctrl+alt", 0);
// 发送 Ctrl+Shift+S
ret = ola.KeyPressHotkey("ctrl+shift+s", 0);

csharp

using OLAPlug;

var ola = new OLAPlugServer();
int ret = ola.KeyPressHotkey("ctrl+alt", 0);
ret = ola.KeyPressHotkey("alt+ctrl+a", 0);

python

from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
ret = ola.KeyPressHotkey("ctrl+alt", 0)
ret = ola.KeyPressHotkey("ctrl+shift+f5", 0)

java

import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
int ret = ola.KeyPressHotkey("ctrl+alt", 0);

import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
// 虚拟机释放鼠标捕获
ret := ola.KeyPressHotkey("ctrl+alt", 0)
// 发送 Ctrl+Shift+S
ret = ola.KeyPressHotkey("ctrl+shift+s", 0)

rust

use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
// 虚拟机释放鼠标捕获
let ret = ola.key_press_hotkey("ctrl+alt", 0);
// 发送 Ctrl+Shift+S
ret = ola.key_press_hotkey("ctrl+shift+s", 0)

cpp

var ola = com("OlaPlug.OlaSoft")
var ret = ola.KeyPressHotkey("ctrl+alt", 0)

vbscript

Set ola = CreateObject("OlaPlug.OlaSoft")
ret = ola.KeyPressHotkey("ctrl+alt", 0)

text

.局部变量 ola, OLAPlug
ola.创建 ()
ret ＝ ola.KeyPressHotkey (“ctrl+alt”, 0)

aardio

import OLAPlugServer;
var ola = OLAPlugServer();
var ret = ola.KeyPressHotkey("ctrl+alt", 0);

text

变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
整数 ret = ola.KeyPressHotkey("ctrl+alt", 0)

cpp

#include "OLAPlugServer.h"

OLAPlugServer ola;
int32_t ret = ola.KeyPressHotkey("ctrl+alt", 0);

原生 DLL 调用

cpp

long instance = CreateCOLAPlugInterFace();
KeyPressHotkey(instance, "ctrl+alt", 0);
KeyPressHotkey(instance, "alt+ctrl+a", 0);

csharp

using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int KeyPressHotkey(long ola, string hotkey_str, int delay);

long instance = CreateCOLAPlugInterFace();
KeyPressHotkey(instance, "ctrl+alt", 0);

python

from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ola.KeyPressHotkey(instance, b"ctrl+alt", 0)

返回值

成功返回 1；失败时接口返回值即为错误码。

错误类型说明

类型	返回值形态	说明
欧拉键鼠驱动（`SimModeType=4`）	有符号 `int32`（常见负数）	驱动 Status 透传，含键鼠专用码与通讯等其它驱动错误。
应用层错误（参数非法、通道未就绪等）	负数十进制（如 `-1003`、`-6001`）	与 BindWindow 相同约定；`GetLastError()` 为对应正数。
权限不足	`-1`（同时 `GetLastError()`=`1001`）	FeatureList 权限检查失败。

常见键鼠相关错误码

返回值（接口）	GetLastError	常量名	说明
`-536858583`	同左（有符号）	`OL_ERROR_KEYMOUSE_NOT_INIT`	键鼠设备未初始化
`-536858582`	同左	`OL_ERROR_KEYMOUSE_SEND_FAILED`	键鼠输入发送失败
`-536858587` 等	同左	`OL_ERROR_COMM_*` 等	驱动通讯失败等，见完整码表
`-6001`	`6001`	`KEYMOUSE_BACKEND_UNAVAILABLE`	VNC/RDP/虚拟机等键鼠通道未就绪
`-1003`	`1003`	`INVALID_ARGUMENT`	参数无效（如未知按键名）
`-1001` / `-1`	`1001`	`PERMISSION_DENIED`	权限不足

完整驱动错误码（含 VT/EPT/通讯/加载等）见驱动错误码说明 - DriverErrorCodes。

错误码去哪里读

方式	说明
本接口返回值 `ret`	失败时 `ret` 本身就是错误码，优先用它对照。
GetLastError / `GetLastError()`	读取最后一次错误码（驱动错误通常与 `ret` 一致；应用层错误为对应正数）。
GetLastErrorString	读取中文说明；用完后须 `FreeStringPtr` 释放。
驱动错误码说明 - DriverErrorCodes	驱动 Status 十进制 / 十六进制完整对照表。

返回值	说明
`1`	成功。
其他	错误码，见上方说明。

与相关接口的区别

接口	用途
KeyDownChar / KeyUpChar	单键按住/释放，需自行组合
KeyPressChar	单键点按
KeyPressStr	字符串逐字输入（含 Shift 大写逻辑）
KeyPressHotkey	组合键一键发送，修饰键自动排序/保序

发送组合键 - KeyPressHotkey ​

函数简介 ​

接口名称 ​

DLL调用 ​

参数说明 ​

输入格式 ​

修饰键排序规则 ​

支持的场景 ​

示例 ​

SDK 调用 ​

原生 DLL 调用 ​

返回值 ​

错误类型说明 ​

常见键鼠相关错误码 ​

错误码去哪里读 ​

与相关接口的区别 ​